We don’t talk about Quarto

We don’t talk about Quarto

We don’t talk about Quarto

Others had more questions…

What is a “Quarto”?

What is a “Quarto”?¹

Ok, but what IS Quarto®?

Ok, but what IS Quarto®?

Quarto® is an open-source scientific and technical publishing system built on Pandoc

function Strong(elem)
  return pandoc.SmallCaps(elem.c)
end

quarto publish document.qmd     

Image: Kobby Mendez

Crafting a cocktail

“Crafting” process for literate programming

“Crafting” process for literate programming

“Crafting” process for literate programming

So what is a .qmd?

A Quarto document i.e. a .qmd is a plain text file, like a .rmd, that can be rendered to many different formats

format: html
engine: knitr

engine: jupyter #< for native Python/Julia without requiring R

```{r cars}
#| eval: false
mtcars |> 
  dplyr::group_by(cyl) |> 
  dplyr::summarize(mean = mean(mpg), .groups = "drop")
```

# Heading 1
This is a sentence with some **bold text**, some *italic text* and an [image](image.png).

So what is Quarto?

Quarto is a command line interface (CLI) that renders plain text formats (.qmd, .rmd, .md) OR mixed formats (.ipynb/Jupyter notebook) into reports, books, websites, presentations and more!

thomasmock$ quarto --help

  Usage:   quarto
  Version: 1.0.0

  Options:
    -h, --help     - Show this help.                            
    -V, --version  - Show the version number for this program.  

  Commands:
    render          [input] [args...]   - Render input file(s) to various document types.            
    preview         [file] [args...]    - Render and preview a document or website project.          
    serve           [input]             - Serve a Shiny interactive document.                        
    create-project  [dir]               - Create a project for rendering multiple documents          
    convert         <input>             - Convert documents to alternate representations.            
    pandoc          [args...]           - Run the version of Pandoc embedded within Quarto.          
    run             [script] [args...]  - Run a TypeScript, R, Python, or Lua script.                
    install         <type> [target]     - Installs an extension or global dependency.                
    publish         [provider] [path]   - Publish a document or project. Available providers include:
    check           [target]            - Verify correct functioning of Quarto installation.         
    help            [command]           - Show this help or the help of a sub-command.               

So what is Quarto?

Patrick

One install, “Batteries included”

• Quarto comes pre-installed with RStudio v2022.07.0 and beyond! Any language, same syntax and approach

Many Quarto formats

Figure Layout

```{r}
#| label: fig-penguins
#| fig-cap: Palmer Penguins layout
#| fig-subcap: 
#|   - "Penguin appearance by species"
#|   - "Bill length vs Bill Depth"
#|   - "Distribution of flipper length"
#| layout: "[[1], [1,1]]"
#| column: page

knitr::include_graphics("images/lter_penguins.png")
bill_len_dep
flipper_hist
```

Interactivity

• Quarto supports {htmlwidgets} and {shiny} in R or Jupyter Widgets for Python. Quarto also includes native support for Observable JS, a set of enhancements to vanilla JavaScript created by Mike Bostock (also the author of D3)

viewof bill_length_min = Inputs.range(
  [32, 50], 
  {value: 35, step: 1, label: "Bill length (min):"}
)
viewof islands = Inputs.checkbox(
  ["Torgersen", "Biscoe", "Dream"], 
  { value: ["Torgersen", "Biscoe"], 
    label: "Islands:"
  }
)

Plot.rectY(filtered, 
  Plot.binX(
    {y: "count"}, 
    {x: "body_mass", fill: "species", thresholds: 20}
  ))
  .plot({
    facet: {
      data: filtered,
      x: "sex",
      y: "species",
      marginRight: 80
    },
    marks: [
      Plot.frame(),
    ]
  }
)

Inputs.table(filtered)

data = FileAttachment("palmer-penguins.csv").csv({ typed: true })

filtered = data.filter(function(penguin) {
  return bill_length_min < penguin.bill_length &&
         islands.includes(penguin.island);
})

Next-Gen RMarkdown, unification

We learned from 10 years of literate programming with knitr + rmarkdown - Quarto is the continuation and unification of the best parts of RMarkdown via knitr.

RMarkdown and knitr are not going away, we’re still supporting it!

Next-Gen RMarkdown, extended for everyone

I feel as if R Markdown’s birth certificate had a letter “R” stamped on it, and Jupyter had a “Python” stamp - Yihui Xie (author of knitr) ¹

Collaboration between multi-lingual teams

Edit: Replaced mispelling of “tookis” with “toolkit”

Photo by zero take

roam in color

Comfort of your own workspace

What to do with my existing .Rmd?

RMarkdown (and knitr) is not going away!

quarto render my-favorite.rmd --to html

What to do with my existing .ipynb?

quarto render my-favorite.ipynb --to html --execute

quarto convert --help

Usage:   quarto convert <input>

Description:

    Convert documents to alternate representations.

  Convert notebook to markdown:                  quarto convert mydocument.ipynb                   
  Convert markdown to notebook:                  quarto convert mydocument.qmd                     
  Convert notebook to markdown, writing to file: quarto convert mydocument.ipynb --output mydoc.qmd

Extending Quarto with extensions

{{< fa thumbs-up >}} 

---
title: "Cool Company 2022 Presentation"
format: coolco-revealjs
---

Quarto Publish

quarto publish --help

  Usage:   quarto publish [provider] [path]
  Version: 1.0.0                          
                                           
  Description:
    Publish a document or project. Available providers include:
                                                               
     - Quarto Pub (quarto-pub)                                 
     - GitHub Pages (gh-pages)                                 
     - RStudio Connect (connect)                               
     - Netlify (netlify)                                       

What about for Data Science at Work?

• Quarto can be used in the latest version (2022.07.0) of RStudio Team today!

Cocktails vs Mixed Drinks

Quarto, crafted with love and care

Development of Quarto is sponsored by RStudio, PBC. The same core team works on both Quarto and R Markdown:

• Carlos Scheidegger (@cscheid)

• Charles Teague (@dragonstyle)

• Christophe Dervieux (@cderv)

• J.J. Allaire (@jjallaire)

• Yihui Xie (@yihui)

Here is the full contributors list. Quarto is open source and we welcome contributions in our github repository as well! https://github.com/quarto-dev/quarto-cli.

Quarto

• Batteries included, shared syntax across output types and languages
• Choose your own editor and your preferred data science language
• RMarkdown still maintained, but majority of new features built into Quarto

Follow @quarto_pub or me @thomas_mock on Twitter to stay up to date!